home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,101 to 4,200 / aol-file-protocol-4400-4101-to-4200.zip / AOLDLs / Business Management / ACS7_ V7.0 Mechanic's Scheduler / MECHANIC.exe / MECH-W70.EXE / MECHANIC.WIN / LHARC.DOC < prev    next >
Text File  |  1994-01-01  |  34KB  |  1,000 lines
  1.  
  2. ------------------------------------------------------------------------
  3.                       Manual for LHA Version 2.05
  4.  
  5.                 translated to English by Kenjirou Okubo
  6.  
  7.                                                    Ver 2.05   1991/01/27
  8. ------------------------------------------------------------------------
  9.                              NIFTY-Serve  SDI00506    HARUYASU YOSHIZAKI
  10.                              ASCII-pcs    pcs02846    Yoshi
  11.                              PC-VAN       FEM12376
  12. ------------------------------------------------------------------------
  13.  
  14.      This is a manual for the Beta test version of LHA.EXE.  LHA is
  15.      an upward compatible and improved version of LH113C v113C.  Since
  16.      Microsoft's DOS 5.0 has an interior command LH.EXE, (for Load
  17.      High) the name has been changed from LH.exe to LHA.exe.  Please
  18.      run this program and tell me if/where improvements are needed.
  19.  
  20.  
  21. 0.  To begin with
  22. -----------------
  23.  
  24.      This is a revised version of LH113C.exe., an archiver which was
  25.      rather slow in execution but tight in compression rate.  I am
  26.      grateful for the support of LH113C's users both in Japan where
  27.      the .LZH file is a standard archived file name and in other
  28.      countries where .LZH is one of a known extension.  I had been
  29.      working for this new version for two years since the last re-
  30.      lease of LH113C.EXE am now glad to announce the release of
  31.      this test version.
  32.  
  33.  
  34.      LHA differs from LH113C:
  35.      -----------------------
  36.  
  37.      LHA is better than LH113 in compression rate, especially with
  38.      large files.  There are a few exceptions if using rather small
  39.      files.  (Under 1 Kb.)  LHA is faster than LH113C in decompres-
  40.      sing, with new static Huffman coding, compared with the older
  41.      dynamic Huffman.  The speed of compression is not as fast as I
  42.      was expecting.  <sigh>
  43.  
  44.      LHA needs more memory than LH113C did.  If there is not enough
  45.      for LHA to work, it may have looser compression rate, although
  46.      it tries to continue execution.  LHA is upper compatible to
  47.      LH113C.  But LH113C is not completely compatible with the LHA
  48.      format.  Please switch to LHA as soon as you can.  With the "/
  49.      o" option, you can dearchive anything made by LH113C, but not
  50.      vice versa.
  51.  
  52.      LHA is distributed as a free program with copyright reserved.
  53.      There is no restriction for the use within private cooperations
  54.      or the use for governmental agencies.  Users must be respon-
  55.      sible for the use of facilities of the software especially of
  56.      the auto ! batch file.  The software is distributed as is.  I
  57.      am not liable for any damage caused by the use of this soft-
  58.      ware.  For commercial use of this software, please refer to our
  59.      distribution policy.
  60.  
  61.  
  62.      Now you can proceed to read the complete description of commands
  63.      and options.  However, if you are not familiar with what an
  64.      archiver is, please refer to the introductory note LHA.HLP
  65.      written especially for LHA.EXE by Irvin Hoff.
  66.  
  67.  
  68.  
  69. 1.  Usage.
  70. ---------
  71.  
  72.   A.  General Format:
  73.   ==================
  74.  
  75.     LHA <command> [/<option> ARC [[DIR\] [FILE]...]...  [-+012|WDIR]...]
  76.  
  77.  
  78.     <command>: if one is not used, you get the help screen or a list of
  79.                FILEs.
  80.     <option>:  you may supply one or more of options explained below.
  81.                (needs an  /  or  -  in front, to designate an option)
  82.     ARC:       archive name.
  83.     DIR:       base directory name.
  84.     FILE:      File name or full pathname if specified.
  85.     WDIR:      Working Directory name.
  86.  
  87.  
  88.   B.  <command>
  89.   =============
  90.  
  91.    a (Add) compress and add to an archive.
  92.  
  93.      Compress and Add files specified to an archive.  If the named
  94.      archive does not exist, then create one with the name.  LHA
  95.      overwrites any file in the archive by the given file name with
  96.      'a' command.  Compare with 'u' command.
  97.  
  98.      The commands 'a' and 'm' are used to make an archive.
  99.  
  100.      < Example 1 >  LHA a ex *.EXE
  101.  
  102.      LHA makes an ARChive ex.LZH, from all the files with extension
  103.      'EXE'.  Extension .LZH is default.
  104.  
  105.  
  106.    u (Update) Compress and Update.
  107.  
  108.      Compress and add files specified to an archive as command 'a'.
  109.      If LHA detects a file with the name same as the one in the
  110.      archive, then LHA selects the new one to add to archive, by
  111.      comparing the time stamp of each.
  112.  
  113.      < Example 2 > LHA u ex *.c
  114.  
  115.      All the FILEs with extension '.C' are archived in ex.LZH.  If
  116.      you already have ex.LZH containing a FILE with the same name,
  117.      only the one with newer time stamp is archived.
  118.  
  119.  
  120.    m (Move)
  121.  
  122.      Compress and add to an archive as 'u' command with checking
  123.      time stamps.  The difference is that LHA deletes all the files
  124.      moved into the archive.
  125.  
  126.      < Example 3 > LHA m ex *.c
  127.  
  128.      does  the same as
  129.  
  130.                   LHA u ex *.c
  131.                   del *.c  .
  132.  
  133.      Watch the second line.  With the /C option, LHA removes all the
  134.      FILEs into the ARChive ignoring time stamps.  You may lose the
  135.      one with the older time stamp.
  136.  
  137.  
  138.    f (Freshen)
  139.  
  140.      LHA looks for a FILE with the same name as the FILE in the
  141.      archive.  If it finds one with a newer time stamp, LHA
  142.      rewrites the one in the archive.  'LHA f /c ARC ' will not
  143.      check the time stamp.
  144.  
  145.      < Example 4 > LHA f ex lha.doc
  146.  
  147.      You have lha.doc compressed and archived in ex.LZH.  You get a
  148.      new lha.doc, then you replace the one in ARChive too.
  149.  
  150.  
  151.    d (Delete)
  152.  
  153.      LHA deletes FILE in ARC.
  154.  
  155.  
  156.    e (Extract)
  157.  
  158.      LHA extracts FILEs from the archive with decompressing.  If LHA
  159.      finds a FILE with a newer FILE with the same name, it skips the
  160.      FILEs.  LHA extracts FILEs from ARChives made by L113C, namely,
  161.      those with the compression ids -lzs-, -lz4-, -lz5-.
  162.  
  163.      <Example 6 > LHA e ex LHA
  164.  
  165.      Extracts all the FILEs in the archive 'ex.LZH'.
  166.  
  167.      < Example 7 > LHA e ex *.com
  168.  
  169.      LHA extracts all the files with extension .COM from 'ex.LZH'.
  170.  
  171.  
  172.   x (eXtract) LHA eXtracts compressed FILE with pathnames.
  173.  
  174.      If LHA can not find any path, then it will create directories.
  175.      FILEs must be archived with full-pathnames.  LHA restores the
  176.      entire directory structure.  'LHA e /x1m1 ARC' does the same.
  177.  
  178.      < EXample 8 > LHA x ex
  179.  
  180.      Suppose '\BIN\CG86.EXE' were among the FILEs in 'EX.LZH'.  LHA
  181.      creates directory '\BIN' if necessary, and extracts 'CG86.EXE'
  182.      there.
  183.  
  184.  
  185.    p (Print) Print FILE on standard out.
  186.  
  187.      LHA prints FILE decompressing from ARC to standard output.
  188.  
  189.      < Example 9 >  LHA  p ex lha.doc
  190.  
  191.      LHA extracts 'LHA.DOC' from 'EX.LZH' and displays it on your
  192.      terminal.
  193.  
  194.      < Example 10 > LHA p ex lha.doc > prn
  195.  
  196.      LHA extracts 'LHA.DOC' from 'EX.LZH' and prints it out from
  197.      your printer.
  198.  
  199.  
  200.    l (List)
  201.  
  202.      LHA lists FILE names in the archive on a line.  A FILE with
  203.      pathname will have a mark '+' on the head of the line.  'LHA
  204.      l /x ARC' shows full-pathnames of FILEs in ARC, and in 2 lines
  205.      per FILE.  You need not type 'l' to have the list.
  206.  
  207.      < Example 11 > LHA lha205.exe
  208.  
  209.      LHA assumes command 'l' and shows list of FILEs archived FILE
  210.      per line.
  211.  
  212.      < Example 11x > LHA /x lha205.exe
  213.  
  214.      You get a similar list but full-pathnames are inserted, and
  215.      each FILE is shown on two lines.
  216.  
  217.      NOTE: Forward slash '/' is used as the pathname separator.
  218.  
  219.  
  220.    v (View)
  221.  
  222.      'LHA v ARC' is the same with 'LHA l /x ARC'.
  223.  
  224.  
  225.    t (Test)
  226.  
  227.      Check the integrity of ARC, by CRC check.
  228.  
  229.      LHA t LHA.EXE or LHA t LHA???.LZH
  230.  
  231.      will announce the authenticity of the file you own.
  232.  
  233.            LHA t LHA.EXE
  234.  
  235.      "This file seems to be ORIGINAL distributed from H.Yoshi."
  236.  
  237.      LHA.exe tests itself for you.  This guarantees the version you
  238.      have is not hacked by anyone, though it is not the full guaran-
  239.      tee in the present state of art.  You can't check LHA.exe if
  240.      you have used executable file compressors such as LZEXE, PKLITE
  241.      or DIET.
  242.  
  243.      < Example 12 > LHA t ex
  244.  
  245.      LHA tests integrity of the FILEs in 'EX.LZH'.
  246.  
  247.      < Example 13 > LHA t LHA.exe
  248.  
  249.      LHA checks if LHA.EXE is the original file distributed.
  250.  
  251.  
  252.    s (Self-extract)
  253.  
  254.      LHA makes a Self-Extracting ARChive from ARC.lzh.  The default
  255.      switch /x0 is assumed when you do not specify.  SFX made with
  256.      the /x0 switch, small model, extracts files on the current
  257.      directory.  You can't activate some programs in the archived
  258.      FILEs automatically with small model.  The size of the SFX file
  259.      is smaller than those made with /x1 switch, large model.
  260.  
  261.      The large model SFX has the ability to restore subdirectory
  262.      structures and can automatically start execution from a FILE
  263.      inside the archive.
  264.  
  265.      < Example 14 > LHA s ex
  266.  
  267.      In this case, LHA makes a small model EX.EXE from EX.LZH.
  268.  
  269.  
  270.  
  271.   C.  </option>
  272.   ============
  273.  
  274.      Each option takes 3 numerical values to define its finer
  275.      actions.  Use 0,1 and 2 to specify.  For some options, the
  276.      values 1 and 2 does the same thing.  You may toggle 0 and 1 by
  277.      '+' and '-" as with LH113C.  You may change switch character
  278.      (option) from  /  to  - if you prefer the '-'.
  279.  
  280.      /x[0|1] (eXtend)
  281.  
  282.      LHA uses eXtended FILE names, namely full-pathnames for FILEs.
  283.  
  284.      You are on the root directory.  Suppose you want to archive the
  285.      FILE '\tc\include\sys\stat.h' in an archive 'ARC.lzh'.  You type
  286.      'LHA a /x1 ARC.lzh \tc\include\sys\stat.h' to store the FILE
  287.      with full-pathname,'\tc\include\sys\stat.h'.  Similarly, you
  288.      have a 2-lined list with full-pathnames with 'l' command.
  289.  
  290.  
  291.      /p[0|1|2] (Precise)
  292.  
  293.      Search file names precisely.
  294.  
  295.      Suppose an ARChive 'TC.LZH' contains both 'STAT.H' and
  296.      'SYS\STAT.H'.  A simple command like 'LHA e TC stat.h' will
  297.      extract both files on the current directory and let one
  298.      override the other.  To avoid such confusion, you can type 'LHA
  299.      e -p TC stat.h' to extract 'STAT.H' only.  While by typing 'LHA
  300.      e -p TC sys\stat.h' you will get 'SYS\STAT.H'.
  301.  
  302.  
  303.      /c[0|1|2]  (ignore Comparison of time)
  304.  
  305.      With commands 'u', 'f', 'e', 'x', LHA ignores the checking of
  306.      time stamps.  With these commands, LHA chooses the newest FILE
  307.      with the same pathname to act on, by default.  This option lets
  308.      LHA ignore the time stamps.
  309.  
  310.  
  311.      /m[0|1|2]  (no Message)
  312.  
  313.      ARC.lzh FILE' gives you the newest FILE n your directory.
  314.      'LHA e /m2 ARC.lzh FILE' dearchives every FILE by choosing
  315.      an unused file extension between 000-999.
  316.  
  317.  
  318.      /a[0|1] (any Attribute)
  319.  
  320.      By default, LHA does not archive FILEs with attribute READONLY.
  321.      This switch enables archiving such FILEs.  Extracted files have
  322.      their archive bit set by default.  With the /a1 switch on, LHA
  323.      restores any attributes of the archived FILEs.
  324.  
  325.  
  326.      /r[0|1|2] (Recursive)
  327.  
  328.      LHA archives and extracts files recursively from
  329.      subdirectories. 'Recursively', means LHA searches all FILEs
  330.      from all subdirectories under the specified directory if there
  331.      is any.
  332.  
  333.      There are three different modes for '/r' switch.
  334.  
  335.  
  336.      /r0: (non-recursive mode, default)
  337.  
  338.      LHA collects files specified by path names only.
  339.  
  340.      /r1:
  341.  
  342.      LHA separates the given pathname into a directory name and FILE
  343.      name.  LHA recursively collects FILEs with the given name from
  344.      all the directories under the directory specified.
  345.  
  346.      < Example 15 > LHA a /r1 source.lzh \source\*.c \source\*.h
  347.  
  348.      LHA collects FILEs with extension C and H from directory
  349.      \source and its subdirectories, probably '\sources\samples\*.c'
  350.      but not '\source\*.obj'.
  351.  
  352.  
  353.      /r2:
  354.  
  355.      LHA recursively collects all the files from all the specified
  356.      subdirectories.  Tree structure of the specified directory is
  357.      archived as it is.
  358.  
  359.      < Example 16 > LHA a /r2x1 a:\*.*
  360.  
  361.  
  362.      NOTE: LH113C has set /x whenever /r is set in e or x commands.
  363.      LHA differs from LH113C in that /x is not set with /r automati-
  364.      cally.
  365.  
  366.      The following questions are the most frequently asked ones:
  367.  
  368.      (1) How do you backup a disk a: ?
  369.  
  370.                         LHA a /r2x1 ARC.lzh a:\
  371.  
  372.      (2) Then how do you retrieve all the directories and files on
  373.          b:?
  374.  
  375.                         LHA x ARC.lzh b:\
  376.  
  377.      /w[0|1|<Directory Name>] (Work directory)
  378.  
  379.      Specify the directory name where LH makes temporary files.
  380.  
  381.                         LHA a /wd:\  ARC.lzh FILEs
  382.  
  383.      set -w switch on.
  384.  
  385.      By default, LHA makes all the temporary files on the directory
  386.      where ARC.lzh is to be made.  It will rename the temporary file
  387.      as ARC.lzh.
  388.  
  389.      LHA makes temporary files on the current directory if no name
  390.      is specified with '/w+'.
  391.  
  392.      When you set Environmental variable 'TMP' this switch is set
  393.      automatically to be 1.
  394.  
  395.      The switch helps LHA when you have not enough room in your base
  396.      directory, or when you have a high speed memory device like RAM
  397.      disk or HARD ram.
  398.  
  399.  
  400.      /n[0|1] (No indicator)
  401.  
  402.      In this version, LHA outputs compressing indicator "ooo....."
  403.      to standard error.  The switch is to suppress this output.
  404.  
  405.      /n1: LHA disables output "ooo....." to indicate its progress.
  406.  
  407.      /n2: LHA disables outputs of filename, compression rates.
  408.  
  409.  
  410.      /t[0|1] (Time stamp)
  411.  
  412.      With command a,u,m,f,d reset time stamp of ARC.lzh according to
  413.      the newest file in the archive. By default, the time stamp of
  414.      an ARC.lzh is the time when the ARC.lzh is made.
  415.  
  416.  
  417.      /z[0|1|2] (Zero compression)
  418.  
  419.      LHA makes an archive without compressing.
  420.  
  421.      /z1: None of the FILEs is compressed
  422.  
  423.      /z2: Compress and archive except for the FILEs with extensions:
  424.           .ARC, .DWC, .LZH, .LZS, .PAK, .ZIP, .ZOO.
  425.  
  426.  
  427.      /o[0|1] (Old compatible compression)
  428.  
  429.      LHA makes an ARChive compatible with LH113C format.  Even in
  430.      this case, LHA makes tighter compression than LH113C ver.1xx.
  431.      Header id is automatically set to be -h1.
  432.  
  433.  
  434.      /h[0|1|2] (Header level)
  435.  
  436.      Choice of header level, default is -h1.
  437.  
  438.  
  439.      /i[0|1] (don't Ignore case)
  440.  
  441.      Recognize Upper and Lower cases.  LH(arc)s have common header
  442.      format in other OS's where cases are recognized as distinct.
  443.      This option is prepared for dearchiving ARChives made by other
  444.      OS'. In the DOS version of LHA, you can't differentiate upper
  445.      and lower when LHA archives FILEs into ARC.  Names are all
  446.      stored in upper case.
  447.  
  448.  
  449.      /l[0|1|2] (Long display ).
  450.  
  451.      LHA outputs filenames in different formats when LHA archives
  452.      and dearchives.
  453.  
  454.       /l0 : FILE names only.
  455.       /l1 : Full-pathnames stored or to be stored in ARChive in 2 lines.
  456.       /l2 : Full-pathname of FILEs accessed by LHA in 2 lines.
  457.  
  458.      < Example 16 > LHA a /r1x1l2 link.lzh c:\link.*
  459.  
  460.      LHA collect link.* with full-pathname from directories below
  461.      c:\, with information from where LHA get these FILEs.
  462.  
  463.  
  464.      /@[1] LHA
  465.  
  466.      recognizes the characters '-' and '@' as the first letter of a
  467.      FILE name.  By default, any file beginning with '@', like
  468.      '@xxx' is recognized as a Response File 'xxx'.  To exit from
  469.      this mode specify '/@0'.  You cannot use '-@0' in this
  470.      particular case.
  471.  
  472.  
  473.   D.  Base Directory.
  474.   ==================
  475.  
  476.      Base directory is not the current nor the root directory.  It
  477.      is the directory on which LHA is executed.  Or you may believe
  478.      that you move to this directory and execute LHA from there.
  479.      You may specify a number of directories as your base
  480.      directories.
  481.  
  482.  
  483.  
  484.   < Example 17 > LHA x program c:\bin\ *.exe *.com c:\temp\ *.man *.doc
  485.                               ~~~~~~~             ~~~~~~~~
  486.      Suppose you are on the directory d:\.  You want to extract
  487.      files with extensions .COM and .EXE on c:\bin, and those with
  488.      extensions .MAN and .DOC on the directory c:\temp.  This is
  489.      equivalent to the following set of command lines.
  490.  
  491.              D>c:
  492.              C>cd \bin
  493.              C>LHA x d:\program *.com *.exe
  494.              C>cd \temp
  495.              C>LHA x d:\program *.man *.doc
  496.  
  497.      Naturally, you can't dearchive a single FILE on multiple
  498.      directories.  The directory specified first has the priority.
  499.  
  500.  
  501.   E.  DOS redirection and response file.
  502.   =====================================
  503.  
  504.      LHA can't accept too many file names on a command line as
  505.      MS-DOS's restriction.  To avoid this inconvenience, now LHA
  506.      accepts PIPES and REDIRECTS of DOS.  Besides LHA can use work
  507.      file called response file to record the names of the files to
  508.      be archived like MAKEFILE for some compilers.
  509.  
  510.  a.  Response File.
  511.  
  512.      The response file name will be marked with the letter '@' as of
  513.      Link.exe.  It is a text file.  You may just write whatever you
  514.      want LHA to be done on this file.  Response file ignores CR
  515.      code and uses space as a separator.  You may write options in
  516.      the response file but you can't nest, calling other response
  517.      file, file names.
  518.  
  519.  
  520.  b.  DOS Pipes and Redirects.
  521.  
  522.      You may specify the same information supplied by a response
  523.      FILE by using pipes or redirections.  You may create a response
  524.      FILE by redirection.
  525.  
  526.      < Example 18 > LHA l /n1 parts > files
  527.                     LHA a newparts @files.
  528.  
  529.      Make a list of files in ARC 'PARTS.LZH' as FILES and use it to
  530.      make a new ARChive 'NEWPARTS.LZH'.  This is done by using the
  531.      response files, after some editing.
  532.  
  533.      < Example 19 > ls | sort | LHA a all
  534.  
  535.      Make a list of files in a directory by ls.exe.  Sort file names
  536.      and make a sorted ARChive ALL.LZH.  Beware of the various
  537.      formats from output of ls.exe.  ls.exe is supposed to list
  538.      files one name per line without any attributes or time stamps.
  539.  
  540.  
  541.   F.  Environmental Variables.
  542.   ===========================
  543.  
  544.  a.  LHA and LH113C
  545.  
  546.      LHA overrides LH113C.  This will reset default optional.
  547.  
  548.  
  549.  b.  TMP
  550.  
  551.      Set working directory as -w option.  In case LHA recognizes no
  552.      working directory, it uses the current directory as the working
  553.      directory and creates temporary files on it.
  554.  
  555.  c.  TZ
  556.  
  557.      the Time Zone (EST, PST, etc.) must be set when you archive
  558.      with the header level -h2- and when you dearchive with -h2-.
  559.      In the Eastern Standard Time Zone you have to set TIME ZONE
  560.      with the DOS command: set TZ=EST+5.  Remember the default
  561.      Remember the default header level is -h1-, in which case you
  562.      are all set.
  563.  
  564.  
  565.   G.  Exit Codes.
  566.   ==============
  567.  
  568.      LH will return following result codes after batch or other
  569.      processes' execution.
  570.  
  571.      0.  Normal.
  572.  
  573.      1.  CRC error, probably with 'e','x','t' commands.
  574.  
  575.      2.  Fatal error.  Process terminated without transactions.
  576.  
  577.      3.  Failed to write temporary files in ARChive.  You may find
  578.          temporary file LHTEMP)2(.LZH on your working directory. You
  579.          may rename this file with extension LZH, and use it as an
  580.          ARChive.
  581.  
  582.  
  583.   H.  Working File Names
  584.   ======================
  585.  
  586.        LHTMP)1(.LZH : Old ARChive renamed.
  587.        LHTMP)2(.LZH : Working file to be renamed as ARChive.
  588.  
  589.  
  590. 2.SFX, Self-Extracting-ARChive
  591. ------------------------------
  592.  
  593.       General Usage:
  594.  
  595.                         SFX.exe [/x] [/!] [/eDIR] [DIR]
  596.  
  597.           /x: do not create new directory.
  598.           /!: auto-execution batch enable.
  599.           [/eDIR],[DIR]; specify directory to extract.
  600.  
  601.  
  602.      SFX.exe is an executable file with FILEs archived in ARChive to
  603.      be extracted by execution.  All the LHA distribution will be in
  604.      Self-Extracting .EXE-format.  Only LHA.exe makes SFX files from
  605.      archive *.lzh made by LHA.exe.  You can't make a Self-Extract-
  606.      ing executable file from ARChive made by 'LH113C.1.xx'.
  607.  
  608.      LHA makes two models of SFX files (a) the small model and (b)
  609.      the large model according to the switch /x0 or /x1, with the
  610.      following special functions.
  611.  
  612.  
  613.    A.  Telop.
  614.    =========
  615.       LHA  displays any file with name '!' if SFX.exe find it archived.
  616.       LHA holds one screen after showing [Y/N] prompt.  LHA proceeds on
  617.       execution if it receives 'Y' and quits execution for 'N'.
  618.  
  619.  
  620.    B.  Directory Specification.
  621.    ===========================
  622.  
  623.      This is possible only for the large model.  You can name the
  624.      directory on which to execute SFX.exe.
  625.  
  626.      < Example 20 > lha205.exe /xec:\user
  627.  
  628.      LHA extracts FILEs in LHA205.EXE on C:\USER.  You may of course
  629.      type:
  630.  
  631.                 LHA e /x0 lha205.exe c:\user ,
  632.  
  633.      to keep the TELOP file.
  634.  
  635.  
  636.    C.  Auto Execution
  637.    ==================
  638.  
  639.      This is possible only for large models.
  640.  
  641.      Archive a batch file with the name "!.bat" and include it in
  642.      the SFX file.  This batch works if and only if you type:
  643.  
  644.                 lha205 -!
  645.  
  646.      LHA always extracts files on the current directory.  Any
  647.      existing "!.bat" file is overwritten.  You can't activate
  648.      existing !.bat by "-!" switch even if there is one on the
  649.      current directory.  The batch file is read if and only if it is
  650.      archived in SFX file.
  651.  
  652.      Two Models of Self-Extracting Files:
  653.  
  654.  
  655.  a.  Small Model  (LHA s SFX.lzh)
  656.  
  657.      This is the default model.
  658.  
  659.      LHA ignores the directory structures even if you make the
  660.      archive file with /x or /r[1|2] switch.  LHA holds only the
  661.      FILE names.  SFX.exe extracts files to the current directory.
  662.  
  663.      There is no limit on the size of SFX.exe as there was for LH113C.
  664.  
  665.  
  666.  b.  Large Model  (LHA s /x1 SFX.lzh)
  667.  
  668.      You can run a batch file to specify the directory to extract
  669.      files. You can retrieve original directory structures with this
  670.      model. You may refrain from creating unexpected structures by
  671.      using /x switch.
  672.  
  673.  
  674. 3.  Main Differences from LH113C
  675. --------------------------------
  676.  
  677.      LHA is an improved version of LH113C in principle.  You will
  678.      notice a number of differences from LHA when comparing with
  679.      LH113C.  Some of the differences will be mentioned at this
  680.      time.  (You may wish to read the LH113.C manual for a better
  681.      comparison if anything appears confusing.)
  682.  
  683.  
  684.      FILE names are not sorted in ARC.  LHA takes FILEs into ARC in
  685.      the order they were stored in the directory when using wild
  686.      cards.  If you specify the order of FILE, then the order is
  687.      reproduced in ARC.  If you add new FILEs in an ARC, then new
  688.      ones will be added to the already existing FILEs.
  689.  
  690.      You may use utilities to sort FILE names in your directory to
  691.      store FILEs in sorted order if you wish.  Or by using pipe you
  692.      may type:
  693.  
  694.      < Example 21 >   ls *.c *.h | sort | LHA a ex.
  695.  
  696.      LHA collects FILEs with extensions C and H sorted in the
  697.      ARChiver 'EX.LZH'.
  698.  
  699.      Consequently, /r switch does not necessarily activate /x switch
  700.      in extraction. In this version of LHA, 'x' command is equiva-
  701.      lent to 'E /x1m1', namely, LHA restores all the tree structures
  702.      of subdirectories.
  703.  
  704.  
  705. 4.  Our distribution Policy
  706. ---------------------------
  707.  
  708.      This software, this document and LHA.EXE, is a
  709.      copyright-reserved free program.  You may use, copy and
  710.      distribute this software free of charge under the following
  711.      conditions.
  712.  
  713.   1.  Never change Copyright statement.
  714.  
  715.   2.  The enclosed documents must be distributed with as a package.
  716.   3.  When you have changed the program, or implemented the program
  717.       for other OS or environment, then you must specify the part
  718.       you have changed.  Also make a clear statement as to your name
  719.       and MAIL address or phone number.
  720.   4.  The author is not liable for any damage on your side caused by
  721.       the use of this program.
  722.   5.  The author has no duty to remedy for the deficiencies of the
  723.       program.
  724.   6.  When you are to distribute this software with publications or
  725.       with your product, you have to print the copyright statement
  726.       somewhere on the disk or on the package.  You cannot
  727.       distribute this software with copyprotected products.
  728.  
  729.  
  730.           As long as those conditions are satisfied, you do not
  731.           have to get the author's permission to use or to dis-
  732.           tribute the software.
  733.  
  734.  
  735. 5.  How to contact the author.
  736. ------------------------------
  737.  
  738.      Please send MAIL to Forum flabo on Nifty serve.  Go Nifty on
  739.      CompuServe and read the instructions there.  Your inquiries or
  740.      your questions are to be addressed to the one of the above
  741.      Nifty forums.  Direct MAIL to the author.
  742.  
  743.     My mail address :  SDI00506 | PFF00253 on Nifty Serve.
  744.                        pcs02846               ASCII-NET pcs.
  745.                        FEM12376               PC-VAN.
  746.  
  747.     Oversea Users may send inquiries, also, to K.Okubo to the address:
  748.                        [74100,2565]        on Compuserve,
  749.                        K.Okubo                Genie,
  750.                        c31834@sinet.ad.jp.    INTERNET,CSNET etc.
  751.  
  752.  
  753. 6. Acknowledgements.
  754. --------------------
  755.  
  756.      What have I done in these days of rapidly changing software
  757.      technologies? My LH113C has contributed for the improvements of
  758.      similar products such as PKZIP(tm) or PAK(tm).  Even with my
  759.      modest Japanese estimate, this I can be proud of at this
  760.      moment.  I thank for all those people who supported and used
  761.      LH113C, voices of users have always been a constant
  762.      encouragement to me.
  763.  
  764.         I express my gratitude to Haruhiko Okumura and members of
  765.         SIG Science of PCVAN for the improvements of algorithms,
  766.  
  767.         to K.Okubo who introduced and supported LH113C on over-
  768.         sea networks such as CompuServe and GEnie.
  769.  
  770.         to Irv Hoff who worked with Kenjirou Okubo on reviewing
  771.         the English version for spelling, grammar and English
  772.         phrasing.
  773.  
  774.         to K.Miki who introduced me to archivers and hold a place
  775.         for experiments,
  776.  
  777.         to members of LSI-Japan who offered excellent versions of
  778.         LSI-C, to the members of Forum FHONYAKU who prepared English
  779.         manual, and finally to all who used LH113C and supported it.
  780.  
  781.  
  782. 7.  Reference
  783. -------------
  784.   1.  Knuth, D.E., Dynamic Huffman Coding, J.Algorithms, 6:163-180.
  785.   2.  Kurita, T.   Harddisk Cook Book.  1987 Shoeisha,Tokyo.
  786.   3.  Kurita, T.  Tool Box of Coputing, Huffman Coding, bit
  787.       70:100-101,1988.
  788.   4.  Okumura,K.,Masuyama,K.,Miki,K.  Practice and theory of Data
  789.       Compression.  The Basic, 70(March):1-65,1989.
  790.   5.  Fiala,E.R., and Greene,D.H., Data Compression with Finite Win-
  791.       dows, Comm.ACM, 32:490-595,1989.
  792.   6.  Okumura,H., and Yoshizaki,H.  Introduction to  Compression
  793.       Algorithm, C Magazine 3:1:44-68,1991.
  794.  
  795.                               - end -
  796.  
  797.  
  798.                          LHA205 HELP GUIDE
  799.  
  800.                  by Irv Hoff, cleared by Yoshi-san
  801.  
  802.                           5 February 1991
  803.  
  804.  
  805. LHA205 - WHAT IS IT?
  806. -------------------
  807.  
  808.      LHA205 is a dual purpose archive program.
  809.  
  810.      1)  Its primary purpose is to take normal binary or text files
  811.          and make them smaller in size.  This saves great amounts of
  812.          storage space, with typical results being approximately 1/4
  813.          to 1/3 of original size.  It can handle any size file that
  814.          can be placed on the disk, together with the compressed file
  815.          it then makes.  Files in excess of 1 Mb may be easily used,
  816.          even though perhaps only 200 Kb RAM might be available.
  817.  
  818.          This eliminates any potential problems from one computer to
  819.          another.
  820.  
  821.          It does this with by using special "compression tables."
  822.          These are automatically built into the program and involve
  823.          mathematical procedures which are simple for a computer.
  824.  
  825.      2)  The secondary purpose is to take more than one of these
  826.          programs and include them in just one file, although each
  827.          will have its own individual name inside that file.
  828.  
  829.                This is called an "archive."  In the days of
  830.                CP/M, they were called "library" files.  In the
  831.                early days of MS-DOS (and other comparable pro-
  832.                grams used by IBM computers) they were called
  833.                .ARC files.
  834.  
  835.                However, as other comparable programs appeared,
  836.                they were given various "extents" to identify
  837.                the program used.  Some sample names are .ARC,
  838.                .DWC, .LZH, .PAK, .ZIP, etc.
  839.  
  840.                Each has its own special characteristics.
  841.                Lists comparing the various programs are
  842.                available.
  843.  
  844.  
  845. ARCHIVE FILES
  846. -------------
  847.  
  848.      LHA205 can have hundreds of files in a single .LZH archive.
  849.      This allows storing complete hard disk directories in a space
  850.      typically 1/2 or less the original total - although many of the
  851.      files might already be archived.
  852.  
  853.      One such check made a file called "TEST.LZH."  It had 200 files
  854.      and was 41% the original directory size.
  855.  
  856.      Not only is this a great saving in size for storage, but puts
  857.      (in this case), the 200 files into one, single file.  This is
  858.      often beneficial.  Among other things, all files associated with
  859.      one program are kept together in the same archive.
  860.  
  861.  
  862. ------------------------------------------------------------------------
  863.  
  864. SIMPLE INSTRUCTIONS FOR USING LHA205:
  865. -------------------------------------
  866.  
  867.      1)  To compress one file called ABC.TXT.  (It will make a
  868.          file called ABC.LZH.)
  869.  
  870. 'a'               LHA205 a ABC ABC.TXT
  871.              or
  872. 'a'               LHA205 a ABC.LZH ABC.TXT
  873.                          ^    ^       ^
  874.                          a    b       c
  875.  
  876.  
  877.                   a  =  command
  878.                   b  =  archive program name
  879.                   c  =  pgm (or pgms) to be added/compressed
  880.  
  881.  
  882.          Either is suitable, one requires more typing.
  883.  
  884.          a)  In this case, the "a" is called a command.  There are
  885.              12 of those available (shown below).  A few are dupli-
  886.              cates to initially help users more familiar with other
  887.              programs.
  888.  
  889.              Typing LHA205 will display this list on the screen.  It
  890.              also gives a very short summary what the command does.
  891.  
  892.  
  893.      2)  ADDING a program to an existing file:
  894.  
  895. 'a'               LHA205 a ABC ABC.DOC
  896.                             ^
  897.                             archive name
  898.  
  899.  
  900.      3)  ADDING SEVERAL files at one time:
  901.  
  902. 'a'               LHA205 a ABC PGM1.EXT PGM2.EXT PGM3.EXT
  903.                             ^
  904.                             archive name
  905.  
  906.  
  907.      4) DELETING a file called PGM4.EXT:
  908.  
  909. 'd'               LHA205 d ABC PGM4
  910.                             ^ 
  911.                             archive name
  912.  
  913.  
  914.      5) EXTRACTING a file called PGM4.EXT:
  915.  
  916. 'e'  (or 'x')     LHA205 e ABC PGM4
  917.                             ^
  918.                             archive name
  919.  
  920.  
  921.      6) LOOKING at the archive contents:
  922.  
  923. 'l'  (or 'v')     LHA205 l ABC PGM4
  924.                             ^
  925.                             archive name
  926.  
  927.  
  928.      7) MOVES files into archive and deletes file from directory:
  929.  
  930. 'm'               LHA205 m ABC PGM1 PGM2 PGM3
  931.                             ^
  932.                             archive name
  933.  
  934.  
  935.      8) DISPLAY a text file in an archive:
  936.  
  937. 'p'               LHA205 p ABC PGM4
  938.                             ^
  939.                             archive name
  940.  
  941. COMMANDS:
  942. ---------
  943.  
  944.      There are 12 commands available (several are duplicates, to
  945.      make the program somewhat more compatible with programs that
  946.      may have better-known to the user.  The 'l' and 'v' are very
  947.      slightly different, the 'v' putting the file name on a line
  948.      by itself.)
  949.  
  950. These are listed by typing just LHA without any command of file name:
  951.  
  952.      a: Add files to archive            u: Update files to archive
  953.      f: Freshen files in archive        m: Move new files into archive
  954.      d: Delete files from archive       p: disPlay files in archive
  955.      e: Extract files from archive      x: eXtract files with directory
  956.      l: List of files in archive        v: View list with directory
  957.      t: Test integrity of archive       s: make a Self-extracting archive
  958.  
  959.  
  960.  
  961. SWITCHES
  962. --------
  963.  
  964.      (There are 15 "switches" which will be explained in the
  965.      MANUAL. Those include:
  966.  
  967.   <option>
  968.      r: Recursively collect files       w: assign Work directory
  969.      x: allow eXtended file names       m: no Message for query
  970.      p: distinguish full Path names     c: skip time-stamp Check
  971.      a: allow any Attributes of files   z: Zero compression (only store)
  972.      t: archive's Time-stamp option     h: select Header level (default = 1)
  973.      o: use Old compatible method       n: display No indicator
  974.      i: not Ignore lower case           l: display Long name with indicator
  975.      @: Response file name option
  976.  
  977.                               - end -
  978.  
  979.  
  980.  
  981.  
  982.  
  983. Additional Syntax from Paul Sax:
  984.  
  985.  
  986. To extract without asking for an overwrite:
  987.  
  988. LHARC E /CHM A:*.LZH
  989.  
  990.  
  991. To compress a drive, with complete pathnames, enter:
  992.  
  993.      LHARC A /LARX TEST C:\*.*
  994.  
  995. To extract a compressed file, with complete pathnames, enter:
  996.  
  997.      LHARC E /LARX TEST 
  998.  
  999.  
  1000.